<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>read_sequence [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_file.html">File</a> / <a href="toc_file_images.html">Images</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">read_sequence</span><span data-if="c" style="display:none;">read_sequence</span><span data-if="cpp" style="display:none;">ReadSequence</span><span data-if="dotnet" style="display:none;">ReadSequence</span><span data-if="python" style="display:none;">read_sequence</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">read_sequence</span><span data-if="c" style="display:none;">read_sequence</span><span data-if="cpp" style="display:none;">ReadSequence</span><span data-if="dotnet" style="display:none;">ReadSequence</span><span data-if="python" style="display:none;">read_sequence</span></code> — Read images.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>read_sequence</b>( : <a href="#Image"><i>Image</i></a> : <a href="#HeaderSize"><i>HeaderSize</i></a>, <a href="#SourceWidth"><i>SourceWidth</i></a>, <a href="#SourceHeight"><i>SourceHeight</i></a>, <a href="#StartRow"><i>StartRow</i></a>, <a href="#StartColumn"><i>StartColumn</i></a>, <a href="#DestWidth"><i>DestWidth</i></a>, <a href="#DestHeight"><i>DestHeight</i></a>, <a href="#PixelType"><i>PixelType</i></a>, <a href="#BitOrder"><i>BitOrder</i></a>, <a href="#ByteOrder"><i>ByteOrder</i></a>, <a href="#Pad"><i>Pad</i></a>, <a href="#Index"><i>Index</i></a>, <a href="#FileName"><i>FileName</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>read_sequence</b>(Hobject* <a href="#Image"><i>Image</i></a>, const Hlong <a href="#HeaderSize"><i>HeaderSize</i></a>, const Hlong <a href="#SourceWidth"><i>SourceWidth</i></a>, const Hlong <a href="#SourceHeight"><i>SourceHeight</i></a>, const Hlong <a href="#StartRow"><i>StartRow</i></a>, const Hlong <a href="#StartColumn"><i>StartColumn</i></a>, const Hlong <a href="#DestWidth"><i>DestWidth</i></a>, const Hlong <a href="#DestHeight"><i>DestHeight</i></a>, const char* <a href="#PixelType"><i>PixelType</i></a>, const char* <a href="#BitOrder"><i>BitOrder</i></a>, const char* <a href="#ByteOrder"><i>ByteOrder</i></a>, const char* <a href="#Pad"><i>Pad</i></a>, const Hlong <a href="#Index"><i>Index</i></a>, const char* <a href="#FileName"><i>FileName</i></a>)</code></p>
<p>
<code>Herror <b>T_read_sequence</b>(Hobject* <a href="#Image"><i>Image</i></a>, const Htuple <a href="#HeaderSize"><i>HeaderSize</i></a>, const Htuple <a href="#SourceWidth"><i>SourceWidth</i></a>, const Htuple <a href="#SourceHeight"><i>SourceHeight</i></a>, const Htuple <a href="#StartRow"><i>StartRow</i></a>, const Htuple <a href="#StartColumn"><i>StartColumn</i></a>, const Htuple <a href="#DestWidth"><i>DestWidth</i></a>, const Htuple <a href="#DestHeight"><i>DestHeight</i></a>, const Htuple <a href="#PixelType"><i>PixelType</i></a>, const Htuple <a href="#BitOrder"><i>BitOrder</i></a>, const Htuple <a href="#ByteOrder"><i>ByteOrder</i></a>, const Htuple <a href="#Pad"><i>Pad</i></a>, const Htuple <a href="#Index"><i>Index</i></a>, const Htuple <a href="#FileName"><i>FileName</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ReadSequence</b>(HObject* <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#HeaderSize"><i>HeaderSize</i></a>, const HTuple&amp; <a href="#SourceWidth"><i>SourceWidth</i></a>, const HTuple&amp; <a href="#SourceHeight"><i>SourceHeight</i></a>, const HTuple&amp; <a href="#StartRow"><i>StartRow</i></a>, const HTuple&amp; <a href="#StartColumn"><i>StartColumn</i></a>, const HTuple&amp; <a href="#DestWidth"><i>DestWidth</i></a>, const HTuple&amp; <a href="#DestHeight"><i>DestHeight</i></a>, const HTuple&amp; <a href="#PixelType"><i>PixelType</i></a>, const HTuple&amp; <a href="#BitOrder"><i>BitOrder</i></a>, const HTuple&amp; <a href="#ByteOrder"><i>ByteOrder</i></a>, const HTuple&amp; <a href="#Pad"><i>Pad</i></a>, const HTuple&amp; <a href="#Index"><i>Index</i></a>, const HTuple&amp; <a href="#FileName"><i>FileName</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>ReadSequence</b>(Hlong <a href="#HeaderSize"><i>HeaderSize</i></a>, Hlong <a href="#SourceWidth"><i>SourceWidth</i></a>, Hlong <a href="#SourceHeight"><i>SourceHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, Hlong <a href="#DestWidth"><i>DestWidth</i></a>, Hlong <a href="#DestHeight"><i>DestHeight</i></a>, const HString&amp; <a href="#PixelType"><i>PixelType</i></a>, const HString&amp; <a href="#BitOrder"><i>BitOrder</i></a>, const HString&amp; <a href="#ByteOrder"><i>ByteOrder</i></a>, const HString&amp; <a href="#Pad"><i>Pad</i></a>, Hlong <a href="#Index"><i>Index</i></a>, const HString&amp; <a href="#FileName"><i>FileName</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>ReadSequence</b>(Hlong <a href="#HeaderSize"><i>HeaderSize</i></a>, Hlong <a href="#SourceWidth"><i>SourceWidth</i></a>, Hlong <a href="#SourceHeight"><i>SourceHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, Hlong <a href="#DestWidth"><i>DestWidth</i></a>, Hlong <a href="#DestHeight"><i>DestHeight</i></a>, const char* <a href="#PixelType"><i>PixelType</i></a>, const char* <a href="#BitOrder"><i>BitOrder</i></a>, const char* <a href="#ByteOrder"><i>ByteOrder</i></a>, const char* <a href="#Pad"><i>Pad</i></a>, Hlong <a href="#Index"><i>Index</i></a>, const char* <a href="#FileName"><i>FileName</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>ReadSequence</b>(Hlong <a href="#HeaderSize"><i>HeaderSize</i></a>, Hlong <a href="#SourceWidth"><i>SourceWidth</i></a>, Hlong <a href="#SourceHeight"><i>SourceHeight</i></a>, Hlong <a href="#StartRow"><i>StartRow</i></a>, Hlong <a href="#StartColumn"><i>StartColumn</i></a>, Hlong <a href="#DestWidth"><i>DestWidth</i></a>, Hlong <a href="#DestHeight"><i>DestHeight</i></a>, const wchar_t* <a href="#PixelType"><i>PixelType</i></a>, const wchar_t* <a href="#BitOrder"><i>BitOrder</i></a>, const wchar_t* <a href="#ByteOrder"><i>ByteOrder</i></a>, const wchar_t* <a href="#Pad"><i>Pad</i></a>, Hlong <a href="#Index"><i>Index</i></a>, const wchar_t* <a href="#FileName"><i>FileName</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ReadSequence</b>(out <a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#HeaderSize"><i>headerSize</i></a>, <a href="HTuple.html">HTuple</a> <a href="#SourceWidth"><i>sourceWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#SourceHeight"><i>sourceHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#StartRow"><i>startRow</i></a>, <a href="HTuple.html">HTuple</a> <a href="#StartColumn"><i>startColumn</i></a>, <a href="HTuple.html">HTuple</a> <a href="#DestWidth"><i>destWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#DestHeight"><i>destHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#PixelType"><i>pixelType</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BitOrder"><i>bitOrder</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ByteOrder"><i>byteOrder</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Pad"><i>pad</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Index"><i>index</i></a>, <a href="HTuple.html">HTuple</a> <a href="#FileName"><i>fileName</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>.<b>ReadSequence</b>(int <a href="#HeaderSize"><i>headerSize</i></a>, int <a href="#SourceWidth"><i>sourceWidth</i></a>, int <a href="#SourceHeight"><i>sourceHeight</i></a>, int <a href="#StartRow"><i>startRow</i></a>, int <a href="#StartColumn"><i>startColumn</i></a>, int <a href="#DestWidth"><i>destWidth</i></a>, int <a href="#DestHeight"><i>destHeight</i></a>, string <a href="#PixelType"><i>pixelType</i></a>, string <a href="#BitOrder"><i>bitOrder</i></a>, string <a href="#ByteOrder"><i>byteOrder</i></a>, string <a href="#Pad"><i>pad</i></a>, int <a href="#Index"><i>index</i></a>, string <a href="#FileName"><i>fileName</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>read_sequence</b>(<a href="#HeaderSize"><i>header_size</i></a>: int, <a href="#SourceWidth"><i>source_width</i></a>: int, <a href="#SourceHeight"><i>source_height</i></a>: int, <a href="#StartRow"><i>start_row</i></a>: int, <a href="#StartColumn"><i>start_column</i></a>: int, <a href="#DestWidth"><i>dest_width</i></a>: int, <a href="#DestHeight"><i>dest_height</i></a>: int, <a href="#PixelType"><i>pixel_type</i></a>: str, <a href="#BitOrder"><i>bit_order</i></a>: str, <a href="#ByteOrder"><i>byte_order</i></a>: str, <a href="#Pad"><i>pad</i></a>: str, <a href="#Index"><i>index</i></a>: int, <a href="#FileName"><i>file_name</i></a>: str) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">read_sequence</span><span data-if="c" style="display:none">read_sequence</span><span data-if="cpp" style="display:none">ReadSequence</span><span data-if="com" style="display:none">ReadSequence</span><span data-if="dotnet" style="display:none">ReadSequence</span><span data-if="python" style="display:none">read_sequence</span></code> reads unformatted image data,
from a file and returns a “suitable” image.  The image data must
be filled consecutively pixel by pixel and line by line.
</p>
<p>Any file headers (with the length <a href="#HeaderSize"><i><code><span data-if="hdevelop" style="display:inline">HeaderSize</span><span data-if="c" style="display:none">HeaderSize</span><span data-if="cpp" style="display:none">HeaderSize</span><span data-if="com" style="display:none">HeaderSize</span><span data-if="dotnet" style="display:none">headerSize</span><span data-if="python" style="display:none">header_size</span></code></i></a> bytes) are
skipped. The parameters <a href="#SourceWidth"><i><code><span data-if="hdevelop" style="display:inline">SourceWidth</span><span data-if="c" style="display:none">SourceWidth</span><span data-if="cpp" style="display:none">SourceWidth</span><span data-if="com" style="display:none">SourceWidth</span><span data-if="dotnet" style="display:none">sourceWidth</span><span data-if="python" style="display:none">source_width</span></code></i></a> and
<a href="#SourceHeight"><i><code><span data-if="hdevelop" style="display:inline">SourceHeight</span><span data-if="c" style="display:none">SourceHeight</span><span data-if="cpp" style="display:none">SourceHeight</span><span data-if="com" style="display:none">SourceHeight</span><span data-if="dotnet" style="display:none">sourceHeight</span><span data-if="python" style="display:none">source_height</span></code></i></a> indicate the size of the filled image.
<a href="#DestWidth"><i><code><span data-if="hdevelop" style="display:inline">DestWidth</span><span data-if="c" style="display:none">DestWidth</span><span data-if="cpp" style="display:none">DestWidth</span><span data-if="com" style="display:none">DestWidth</span><span data-if="dotnet" style="display:none">destWidth</span><span data-if="python" style="display:none">dest_width</span></code></i></a> and <a href="#DestHeight"><i><code><span data-if="hdevelop" style="display:inline">DestHeight</span><span data-if="c" style="display:none">DestHeight</span><span data-if="cpp" style="display:none">DestHeight</span><span data-if="com" style="display:none">DestHeight</span><span data-if="dotnet" style="display:none">destHeight</span><span data-if="python" style="display:none">dest_height</span></code></i></a> indicate the size of the
image. In the simplest case these parameters are the same. However,
areas can also be read.  The upper left corner of the required image
area can be determined via <a href="#StartRow"><i><code><span data-if="hdevelop" style="display:inline">StartRow</span><span data-if="c" style="display:none">StartRow</span><span data-if="cpp" style="display:none">StartRow</span><span data-if="com" style="display:none">StartRow</span><span data-if="dotnet" style="display:none">startRow</span><span data-if="python" style="display:none">start_row</span></code></i></a> and
<a href="#StartColumn"><i><code><span data-if="hdevelop" style="display:inline">StartColumn</span><span data-if="c" style="display:none">StartColumn</span><span data-if="cpp" style="display:none">StartColumn</span><span data-if="com" style="display:none">StartColumn</span><span data-if="dotnet" style="display:none">startColumn</span><span data-if="python" style="display:none">start_column</span></code></i></a>.
</p>
<p>The pixel types <i><span data-if="hdevelop" style="display:inline">'bit'</span><span data-if="c" style="display:none">"bit"</span><span data-if="cpp" style="display:none">"bit"</span><span data-if="com" style="display:none">"bit"</span><span data-if="dotnet" style="display:none">"bit"</span><span data-if="python" style="display:none">"bit"</span></i>, <i><span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span></i>, <i><span data-if="hdevelop" style="display:inline">'short'</span><span data-if="c" style="display:none">"short"</span><span data-if="cpp" style="display:none">"short"</span><span data-if="com" style="display:none">"short"</span><span data-if="dotnet" style="display:none">"short"</span><span data-if="python" style="display:none">"short"</span></i>
(16 bits, unsigned), <i><span data-if="hdevelop" style="display:inline">'signed_short'</span><span data-if="c" style="display:none">"signed_short"</span><span data-if="cpp" style="display:none">"signed_short"</span><span data-if="com" style="display:none">"signed_short"</span><span data-if="dotnet" style="display:none">"signed_short"</span><span data-if="python" style="display:none">"signed_short"</span></i> (16 bits, signed),
<i><span data-if="hdevelop" style="display:inline">'long'</span><span data-if="c" style="display:none">"long"</span><span data-if="cpp" style="display:none">"long"</span><span data-if="com" style="display:none">"long"</span><span data-if="dotnet" style="display:none">"long"</span><span data-if="python" style="display:none">"long"</span></i> (32 bits, signed), <i><span data-if="hdevelop" style="display:inline">'swapped_long'</span><span data-if="c" style="display:none">"swapped_long"</span><span data-if="cpp" style="display:none">"swapped_long"</span><span data-if="com" style="display:none">"swapped_long"</span><span data-if="dotnet" style="display:none">"swapped_long"</span><span data-if="python" style="display:none">"swapped_long"</span></i> (32 bits,
with swapped segments), and <i><span data-if="hdevelop" style="display:inline">'real'</span><span data-if="c" style="display:none">"real"</span><span data-if="cpp" style="display:none">"real"</span><span data-if="com" style="display:none">"real"</span><span data-if="dotnet" style="display:none">"real"</span><span data-if="python" style="display:none">"real"</span></i> (32 bit floating point
numbers) are supported.  Furthermore, 该算子
<code><span data-if="hdevelop" style="display:inline">read_sequence</span><span data-if="c" style="display:none">read_sequence</span><span data-if="cpp" style="display:none">ReadSequence</span><span data-if="com" style="display:none">ReadSequence</span><span data-if="dotnet" style="display:none">ReadSequence</span><span data-if="python" style="display:none">read_sequence</span></code> enables the extraction of components of a RBG
image, if a triple of three bytes (in the sequence “red”,
“green”, “blue”) was filed in the image file.  For the red
component the pixel type <i><span data-if="hdevelop" style="display:inline">'r_byte'</span><span data-if="c" style="display:none">"r_byte"</span><span data-if="cpp" style="display:none">"r_byte"</span><span data-if="com" style="display:none">"r_byte"</span><span data-if="dotnet" style="display:none">"r_byte"</span><span data-if="python" style="display:none">"r_byte"</span></i> must be chosen, and
correspondingly for the green and blue components <i><span data-if="hdevelop" style="display:inline">'g_byte'</span><span data-if="c" style="display:none">"g_byte"</span><span data-if="cpp" style="display:none">"g_byte"</span><span data-if="com" style="display:none">"g_byte"</span><span data-if="dotnet" style="display:none">"g_byte"</span><span data-if="python" style="display:none">"g_byte"</span></i>
or <i><span data-if="hdevelop" style="display:inline">'b_byte'</span><span data-if="c" style="display:none">"b_byte"</span><span data-if="cpp" style="display:none">"b_byte"</span><span data-if="com" style="display:none">"b_byte"</span><span data-if="dotnet" style="display:none">"b_byte"</span><span data-if="python" style="display:none">"b_byte"</span></i>, respectively.
</p>
<p><i><span data-if="hdevelop" style="display:inline">'MSBFirst'</span><span data-if="c" style="display:none">"MSBFirst"</span><span data-if="cpp" style="display:none">"MSBFirst"</span><span data-if="com" style="display:none">"MSBFirst"</span><span data-if="dotnet" style="display:none">"MSBFirst"</span><span data-if="python" style="display:none">"MSBFirst"</span></i> (most significant bit first) or the inversion
thereof (<i><span data-if="hdevelop" style="display:inline">'LSBFirst'</span><span data-if="c" style="display:none">"LSBFirst"</span><span data-if="cpp" style="display:none">"LSBFirst"</span><span data-if="com" style="display:none">"LSBFirst"</span><span data-if="dotnet" style="display:none">"LSBFirst"</span><span data-if="python" style="display:none">"LSBFirst"</span></i>) can be chosen for the bit order
(<a href="#BitOrder"><i><code><span data-if="hdevelop" style="display:inline">BitOrder</span><span data-if="c" style="display:none">BitOrder</span><span data-if="cpp" style="display:none">BitOrder</span><span data-if="com" style="display:none">BitOrder</span><span data-if="dotnet" style="display:none">bitOrder</span><span data-if="python" style="display:none">bit_order</span></code></i></a>). The byte orders (<a href="#ByteOrder"><i><code><span data-if="hdevelop" style="display:inline">ByteOrder</span><span data-if="c" style="display:none">ByteOrder</span><span data-if="cpp" style="display:none">ByteOrder</span><span data-if="com" style="display:none">ByteOrder</span><span data-if="dotnet" style="display:none">byteOrder</span><span data-if="python" style="display:none">byte_order</span></code></i></a>)
<i><span data-if="hdevelop" style="display:inline">'MSBFirst'</span><span data-if="c" style="display:none">"MSBFirst"</span><span data-if="cpp" style="display:none">"MSBFirst"</span><span data-if="com" style="display:none">"MSBFirst"</span><span data-if="dotnet" style="display:none">"MSBFirst"</span><span data-if="python" style="display:none">"MSBFirst"</span></i> (most significant byte first) or
<i><span data-if="hdevelop" style="display:inline">'LSBFirst'</span><span data-if="c" style="display:none">"LSBFirst"</span><span data-if="cpp" style="display:none">"LSBFirst"</span><span data-if="com" style="display:none">"LSBFirst"</span><span data-if="dotnet" style="display:none">"LSBFirst"</span><span data-if="python" style="display:none">"LSBFirst"</span></i>, respectively, are processed analogously.
Finally an alignment (<a href="#Pad"><i><code><span data-if="hdevelop" style="display:inline">Pad</span><span data-if="c" style="display:none">Pad</span><span data-if="cpp" style="display:none">Pad</span><span data-if="com" style="display:none">Pad</span><span data-if="dotnet" style="display:none">pad</span><span data-if="python" style="display:none">pad</span></code></i></a>) can be set at the end of the
line: <i><span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span></i>, <i><span data-if="hdevelop" style="display:inline">'short'</span><span data-if="c" style="display:none">"short"</span><span data-if="cpp" style="display:none">"short"</span><span data-if="com" style="display:none">"short"</span><span data-if="dotnet" style="display:none">"short"</span><span data-if="python" style="display:none">"short"</span></i> or <i><span data-if="hdevelop" style="display:inline">'long'</span><span data-if="c" style="display:none">"long"</span><span data-if="cpp" style="display:none">"long"</span><span data-if="com" style="display:none">"long"</span><span data-if="dotnet" style="display:none">"long"</span><span data-if="python" style="display:none">"long"</span></i>.  If a
whole image sequence is stored in the file a single image (beginning
at Index 1) can be chosen via the parameter <a href="#Index"><i><code><span data-if="hdevelop" style="display:inline">Index</span><span data-if="c" style="display:none">Index</span><span data-if="cpp" style="display:none">Index</span><span data-if="com" style="display:none">Index</span><span data-if="dotnet" style="display:none">index</span><span data-if="python" style="display:none">index</span></code></i></a>.
</p>
<p>Image files are searched in the current directory (determined by the
environment variable) and in the image directory of HALCON.  The
image directory of HALCON is preset at <code>'.'</code> and
<code>'/usr/local/halcon/images'</code> in a Unix-like environment and can be
set via 该算子 <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system</span><span data-if="c" style="display:none">set_system</span><span data-if="cpp" style="display:none">SetSystem</span><span data-if="com" style="display:none">SetSystem</span><span data-if="dotnet" style="display:none">SetSystem</span><span data-if="python" style="display:none">set_system</span></code></a>.  More than one image
directory can be indicated.  This is done by separating the
individual directories by a colon.
</p>
<p>Furthermore the search path can be set via the environment variable
HALCONIMAGES (same structure as <i><span data-if="hdevelop" style="display:inline">'image_dir'</span><span data-if="c" style="display:none">"image_dir"</span><span data-if="cpp" style="display:none">"image_dir"</span><span data-if="com" style="display:none">"image_dir"</span><span data-if="dotnet" style="display:none">"image_dir"</span><span data-if="python" style="display:none">"image_dir"</span></i>).  Example:
</p>
<p><span class="pre">
     setenv HALCONIMAGES "/usr/images:/usr/local/halcon/images"
</span>
</p>
<p>HALCON also searches images in the subdirectory
<code>'images'</code> (Images for the program examples).  The
environment variable HALCONROOT is used for the HALCON directory.</p>
<h2 id="sec_attention">注意</h2>
<p>If files of pixel type <i><span data-if="hdevelop" style="display:inline">'real'</span><span data-if="c" style="display:none">"real"</span><span data-if="cpp" style="display:none">"real"</span><span data-if="com" style="display:none">"real"</span><span data-if="dotnet" style="display:none">"real"</span><span data-if="python" style="display:none">"real"</span></i> are read and the byte order
is chosen incorrectly (i.e., differently from the byte order in
which the data is stored in the file) program error and even crashes
because of floating point exceptions may result.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (output_object)  </span><span>image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte / int2 / uint2 / int4)</span>
</div>
<p class="pardesc">Image read.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="HeaderSize" class="parname"><b><code><span data-if="hdevelop" style="display:inline">HeaderSize</span><span data-if="c" style="display:none">HeaderSize</span><span data-if="cpp" style="display:none">HeaderSize</span><span data-if="com" style="display:none">HeaderSize</span><span data-if="dotnet" style="display:none">headerSize</span><span data-if="python" style="display:none">header_size</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of bytes for file header.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">HeaderSize</span>
    <span data-if="c" style="display:none">HeaderSize</span>
    <span data-if="cpp" style="display:none">HeaderSize</span>
    <span data-if="com" style="display:none">HeaderSize</span>
    <span data-if="dotnet" style="display:none">headerSize</span>
    <span data-if="python" style="display:none">header_size</span>
    </code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="SourceWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SourceWidth</span><span data-if="c" style="display:none">SourceWidth</span><span data-if="cpp" style="display:none">SourceWidth</span><span data-if="com" style="display:none">SourceWidth</span><span data-if="dotnet" style="display:none">sourceWidth</span><span data-if="python" style="display:none">source_width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of image columns of the filed image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">SourceWidth</span>
    <span data-if="c" style="display:none">SourceWidth</span>
    <span data-if="cpp" style="display:none">SourceWidth</span>
    <span data-if="com" style="display:none">SourceWidth</span>
    <span data-if="dotnet" style="display:none">sourceWidth</span>
    <span data-if="python" style="display:none">source_width</span>
    </code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="SourceHeight" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SourceHeight</span><span data-if="c" style="display:none">SourceHeight</span><span data-if="cpp" style="display:none">SourceHeight</span><span data-if="com" style="display:none">SourceHeight</span><span data-if="dotnet" style="display:none">sourceHeight</span><span data-if="python" style="display:none">source_height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of image lines of the filed image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">SourceHeight</span>
    <span data-if="c" style="display:none">SourceHeight</span>
    <span data-if="cpp" style="display:none">SourceHeight</span>
    <span data-if="com" style="display:none">SourceHeight</span>
    <span data-if="dotnet" style="display:none">sourceHeight</span>
    <span data-if="python" style="display:none">source_height</span>
    </code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="StartRow" class="parname"><b><code><span data-if="hdevelop" style="display:inline">StartRow</span><span data-if="c" style="display:none">StartRow</span><span data-if="cpp" style="display:none">StartRow</span><span data-if="com" style="display:none">StartRow</span><span data-if="dotnet" style="display:none">startRow</span><span data-if="python" style="display:none">start_row</span></code></b> (input_control)  </span><span>point.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Starting point of image area (line).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">StartRow</span>
    <span data-if="c" style="display:none">StartRow</span>
    <span data-if="cpp" style="display:none">StartRow</span>
    <span data-if="com" style="display:none">StartRow</span>
    <span data-if="dotnet" style="display:none">startRow</span>
    <span data-if="python" style="display:none">start_row</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>StartRow &lt; SourceHeight</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="StartColumn" class="parname"><b><code><span data-if="hdevelop" style="display:inline">StartColumn</span><span data-if="c" style="display:none">StartColumn</span><span data-if="cpp" style="display:none">StartColumn</span><span data-if="com" style="display:none">StartColumn</span><span data-if="dotnet" style="display:none">startColumn</span><span data-if="python" style="display:none">start_column</span></code></b> (input_control)  </span><span>point.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Starting point of image area (column).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">StartColumn</span>
    <span data-if="c" style="display:none">StartColumn</span>
    <span data-if="cpp" style="display:none">StartColumn</span>
    <span data-if="com" style="display:none">StartColumn</span>
    <span data-if="dotnet" style="display:none">startColumn</span>
    <span data-if="python" style="display:none">start_column</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>StartColumn &lt; SourceWidth</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="DestWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">DestWidth</span><span data-if="c" style="display:none">DestWidth</span><span data-if="cpp" style="display:none">DestWidth</span><span data-if="com" style="display:none">DestWidth</span><span data-if="dotnet" style="display:none">destWidth</span><span data-if="python" style="display:none">dest_width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of image columns of output image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">DestWidth</span>
    <span data-if="c" style="display:none">DestWidth</span>
    <span data-if="cpp" style="display:none">DestWidth</span>
    <span data-if="com" style="display:none">DestWidth</span>
    <span data-if="dotnet" style="display:none">destWidth</span>
    <span data-if="python" style="display:none">dest_width</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>DestWidth &lt;= SourceWidth</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="DestHeight" class="parname"><b><code><span data-if="hdevelop" style="display:inline">DestHeight</span><span data-if="c" style="display:none">DestHeight</span><span data-if="cpp" style="display:none">DestHeight</span><span data-if="com" style="display:none">DestHeight</span><span data-if="dotnet" style="display:none">destHeight</span><span data-if="python" style="display:none">dest_height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of image lines of output image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">DestHeight</span>
    <span data-if="c" style="display:none">DestHeight</span>
    <span data-if="cpp" style="display:none">DestHeight</span>
    <span data-if="com" style="display:none">DestHeight</span>
    <span data-if="dotnet" style="display:none">destHeight</span>
    <span data-if="python" style="display:none">dest_height</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>DestHeight &lt;= SourceHeight</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="PixelType" class="parname"><b><code><span data-if="hdevelop" style="display:inline">PixelType</span><span data-if="c" style="display:none">PixelType</span><span data-if="cpp" style="display:none">PixelType</span><span data-if="com" style="display:none">PixelType</span><span data-if="dotnet" style="display:none">pixelType</span><span data-if="python" style="display:none">pixel_type</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Type of pixel values.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'byte'</span>
    <span data-if="c" style="display:none">"byte"</span>
    <span data-if="cpp" style="display:none">"byte"</span>
    <span data-if="com" style="display:none">"byte"</span>
    <span data-if="dotnet" style="display:none">"byte"</span>
    <span data-if="python" style="display:none">"byte"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'b_byte'</span><span data-if="c" style="display:none">"b_byte"</span><span data-if="cpp" style="display:none">"b_byte"</span><span data-if="com" style="display:none">"b_byte"</span><span data-if="dotnet" style="display:none">"b_byte"</span><span data-if="python" style="display:none">"b_byte"</span>, <span data-if="hdevelop" style="display:inline">'bit'</span><span data-if="c" style="display:none">"bit"</span><span data-if="cpp" style="display:none">"bit"</span><span data-if="com" style="display:none">"bit"</span><span data-if="dotnet" style="display:none">"bit"</span><span data-if="python" style="display:none">"bit"</span>, <span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span>, <span data-if="hdevelop" style="display:inline">'g_byte'</span><span data-if="c" style="display:none">"g_byte"</span><span data-if="cpp" style="display:none">"g_byte"</span><span data-if="com" style="display:none">"g_byte"</span><span data-if="dotnet" style="display:none">"g_byte"</span><span data-if="python" style="display:none">"g_byte"</span>, <span data-if="hdevelop" style="display:inline">'long'</span><span data-if="c" style="display:none">"long"</span><span data-if="cpp" style="display:none">"long"</span><span data-if="com" style="display:none">"long"</span><span data-if="dotnet" style="display:none">"long"</span><span data-if="python" style="display:none">"long"</span>, <span data-if="hdevelop" style="display:inline">'r_byte'</span><span data-if="c" style="display:none">"r_byte"</span><span data-if="cpp" style="display:none">"r_byte"</span><span data-if="com" style="display:none">"r_byte"</span><span data-if="dotnet" style="display:none">"r_byte"</span><span data-if="python" style="display:none">"r_byte"</span>, <span data-if="hdevelop" style="display:inline">'real'</span><span data-if="c" style="display:none">"real"</span><span data-if="cpp" style="display:none">"real"</span><span data-if="com" style="display:none">"real"</span><span data-if="dotnet" style="display:none">"real"</span><span data-if="python" style="display:none">"real"</span>, <span data-if="hdevelop" style="display:inline">'short'</span><span data-if="c" style="display:none">"short"</span><span data-if="cpp" style="display:none">"short"</span><span data-if="com" style="display:none">"short"</span><span data-if="dotnet" style="display:none">"short"</span><span data-if="python" style="display:none">"short"</span>, <span data-if="hdevelop" style="display:inline">'signed_short'</span><span data-if="c" style="display:none">"signed_short"</span><span data-if="cpp" style="display:none">"signed_short"</span><span data-if="com" style="display:none">"signed_short"</span><span data-if="dotnet" style="display:none">"signed_short"</span><span data-if="python" style="display:none">"signed_short"</span>, <span data-if="hdevelop" style="display:inline">'swapped_long'</span><span data-if="c" style="display:none">"swapped_long"</span><span data-if="cpp" style="display:none">"swapped_long"</span><span data-if="com" style="display:none">"swapped_long"</span><span data-if="dotnet" style="display:none">"swapped_long"</span><span data-if="python" style="display:none">"swapped_long"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="BitOrder" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BitOrder</span><span data-if="c" style="display:none">BitOrder</span><span data-if="cpp" style="display:none">BitOrder</span><span data-if="com" style="display:none">BitOrder</span><span data-if="dotnet" style="display:none">bitOrder</span><span data-if="python" style="display:none">bit_order</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Sequence of bits within one byte.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'MSBFirst'</span>
    <span data-if="c" style="display:none">"MSBFirst"</span>
    <span data-if="cpp" style="display:none">"MSBFirst"</span>
    <span data-if="com" style="display:none">"MSBFirst"</span>
    <span data-if="dotnet" style="display:none">"MSBFirst"</span>
    <span data-if="python" style="display:none">"MSBFirst"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'LSBFirst'</span><span data-if="c" style="display:none">"LSBFirst"</span><span data-if="cpp" style="display:none">"LSBFirst"</span><span data-if="com" style="display:none">"LSBFirst"</span><span data-if="dotnet" style="display:none">"LSBFirst"</span><span data-if="python" style="display:none">"LSBFirst"</span>, <span data-if="hdevelop" style="display:inline">'MSBFirst'</span><span data-if="c" style="display:none">"MSBFirst"</span><span data-if="cpp" style="display:none">"MSBFirst"</span><span data-if="com" style="display:none">"MSBFirst"</span><span data-if="dotnet" style="display:none">"MSBFirst"</span><span data-if="python" style="display:none">"MSBFirst"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ByteOrder" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ByteOrder</span><span data-if="c" style="display:none">ByteOrder</span><span data-if="cpp" style="display:none">ByteOrder</span><span data-if="com" style="display:none">ByteOrder</span><span data-if="dotnet" style="display:none">byteOrder</span><span data-if="python" style="display:none">byte_order</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Sequence of bytes within one
'short' unit.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'MSBFirst'</span>
    <span data-if="c" style="display:none">"MSBFirst"</span>
    <span data-if="cpp" style="display:none">"MSBFirst"</span>
    <span data-if="com" style="display:none">"MSBFirst"</span>
    <span data-if="dotnet" style="display:none">"MSBFirst"</span>
    <span data-if="python" style="display:none">"MSBFirst"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'LSBFirst'</span><span data-if="c" style="display:none">"LSBFirst"</span><span data-if="cpp" style="display:none">"LSBFirst"</span><span data-if="com" style="display:none">"LSBFirst"</span><span data-if="dotnet" style="display:none">"LSBFirst"</span><span data-if="python" style="display:none">"LSBFirst"</span>, <span data-if="hdevelop" style="display:inline">'MSBFirst'</span><span data-if="c" style="display:none">"MSBFirst"</span><span data-if="cpp" style="display:none">"MSBFirst"</span><span data-if="com" style="display:none">"MSBFirst"</span><span data-if="dotnet" style="display:none">"MSBFirst"</span><span data-if="python" style="display:none">"MSBFirst"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Pad" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Pad</span><span data-if="c" style="display:none">Pad</span><span data-if="cpp" style="display:none">Pad</span><span data-if="com" style="display:none">Pad</span><span data-if="dotnet" style="display:none">pad</span><span data-if="python" style="display:none">pad</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Data units within one image line (alignment).</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'byte'</span>
    <span data-if="c" style="display:none">"byte"</span>
    <span data-if="cpp" style="display:none">"byte"</span>
    <span data-if="com" style="display:none">"byte"</span>
    <span data-if="dotnet" style="display:none">"byte"</span>
    <span data-if="python" style="display:none">"byte"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span>, <span data-if="hdevelop" style="display:inline">'long'</span><span data-if="c" style="display:none">"long"</span><span data-if="cpp" style="display:none">"long"</span><span data-if="com" style="display:none">"long"</span><span data-if="dotnet" style="display:none">"long"</span><span data-if="python" style="display:none">"long"</span>, <span data-if="hdevelop" style="display:inline">'short'</span><span data-if="c" style="display:none">"short"</span><span data-if="cpp" style="display:none">"short"</span><span data-if="com" style="display:none">"short"</span><span data-if="dotnet" style="display:none">"short"</span><span data-if="python" style="display:none">"short"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Index" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Index</span><span data-if="c" style="display:none">Index</span><span data-if="cpp" style="display:none">Index</span><span data-if="com" style="display:none">Index</span><span data-if="dotnet" style="display:none">index</span><span data-if="python" style="display:none">index</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of images in the file.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Index</span>
    <span data-if="c" style="display:none">Index</span>
    <span data-if="cpp" style="display:none">Index</span>
    <span data-if="com" style="display:none">Index</span>
    <span data-if="dotnet" style="display:none">index</span>
    <span data-if="python" style="display:none">index</span>
    </code> (lin)</p>
</div>
  <div class="par">
<div class="parhead">
<span id="FileName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FileName</span><span data-if="c" style="display:none">FileName</span><span data-if="cpp" style="display:none">FileName</span><span data-if="com" style="display:none">FileName</span><span data-if="dotnet" style="display:none">fileName</span><span data-if="python" style="display:none">file_name</span></code></b> (input_control)  </span><span>filename.read <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Name of input file.</p>
</div>
<h2 id="sec_result">结果</h2>
<p>If the parameter values are correct 该算子
<code><span data-if="hdevelop" style="display:inline">read_sequence</span><span data-if="c" style="display:none">read_sequence</span><span data-if="cpp" style="display:none">ReadSequence</span><span data-if="com" style="display:none">ReadSequence</span><span data-if="dotnet" style="display:none">ReadSequence</span><span data-if="python" style="display:none">read_sequence</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  Otherwise an
exception is raised.</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="disp_image.html"><span data-if="hdevelop" style="display:inline">disp_image</span><span data-if="c" style="display:none">disp_image</span><span data-if="cpp" style="display:none">DispImage</span><span data-if="com" style="display:none">DispImage</span><span data-if="dotnet" style="display:none">DispImage</span><span data-if="python" style="display:none">disp_image</span></a></code>, 
<code><a href="count_channels.html"><span data-if="hdevelop" style="display:inline">count_channels</span><span data-if="c" style="display:none">count_channels</span><span data-if="cpp" style="display:none">CountChannels</span><span data-if="com" style="display:none">CountChannels</span><span data-if="dotnet" style="display:none">CountChannels</span><span data-if="python" style="display:none">count_channels</span></a></code>, 
<code><a href="decompose3.html"><span data-if="hdevelop" style="display:inline">decompose3</span><span data-if="c" style="display:none">decompose3</span><span data-if="cpp" style="display:none">Decompose3</span><span data-if="com" style="display:none">Decompose3</span><span data-if="dotnet" style="display:none">Decompose3</span><span data-if="python" style="display:none">decompose3</span></a></code>, 
<code><a href="write_image.html"><span data-if="hdevelop" style="display:inline">write_image</span><span data-if="c" style="display:none">write_image</span><span data-if="cpp" style="display:none">WriteImage</span><span data-if="com" style="display:none">WriteImage</span><span data-if="dotnet" style="display:none">WriteImage</span><span data-if="python" style="display:none">write_image</span></a></code>, 
<code><a href="rgb1_to_gray.html"><span data-if="hdevelop" style="display:inline">rgb1_to_gray</span><span data-if="c" style="display:none">rgb1_to_gray</span><span data-if="cpp" style="display:none">Rgb1ToGray</span><span data-if="com" style="display:none">Rgb1ToGray</span><span data-if="dotnet" style="display:none">Rgb1ToGray</span><span data-if="python" style="display:none">rgb1_to_gray</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="read_image.html"><span data-if="hdevelop" style="display:inline">read_image</span><span data-if="c" style="display:none">read_image</span><span data-if="cpp" style="display:none">ReadImage</span><span data-if="com" style="display:none">ReadImage</span><span data-if="dotnet" style="display:none">ReadImage</span><span data-if="python" style="display:none">read_image</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="read_image.html"><span data-if="hdevelop" style="display:inline">read_image</span><span data-if="c" style="display:none">read_image</span><span data-if="cpp" style="display:none">ReadImage</span><span data-if="com" style="display:none">ReadImage</span><span data-if="dotnet" style="display:none">ReadImage</span><span data-if="python" style="display:none">read_image</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
